উদাহরণ সহ Custom Exception Handling

Spring Security এ Custom Exception Handling একটি গুরুত্বপূর্ণ দিক, কারণ এটি ব্যবহারকারীকে সঠিক এবং পরিষ্কার ত্রুটি বার্তা প্রদান করতে সাহায্য করে যখন কিছু ভুল হয়। Spring Security ডিফল্টভাবে কিছু সাধারণ নিরাপত্তা ত্রুটি যেমন AuthenticationException এবং AccessDeniedException পরিচালনা করে, তবে আপনি আপনার প্রয়োজন অনুসারে কাস্টম ত্রুটি হ্যান্ডলিং যুক্ত করতে পারেন।

এখানে Custom Exception Handling কিভাবে করতে হয়, তার একটি উদাহরণ দেওয়া হলো:

1. Spring Security তে Custom Exception Handling

Spring Security তে Custom Exception Handling এর জন্য আমরা নিম্নলিখিত স্টেপগুলো অনুসরণ করব:

1. Custom Exception Class তৈরি করা।
2. Exception Handler কনফিগার করা, যাতে ত্রুটির ক্ষেত্রে কাস্টম রেসপন্স দেওয়া যায়।
3. Spring Security কনফিগারেশন যেখানে exception handling প্রক্রিয়া কাস্টমাইজ করা যাবে।

2. উদাহরণ: Custom AuthenticationException Handling

i. Custom AuthenticationException তৈরি করা

প্রথমে, আমরা একটি কাস্টম AuthenticationException তৈরি করি যা Spring Security তে Authentication সমস্যা হওয়ার সময় ব্যবহার হবে।

import org.springframework.security.core.AuthenticationException;

public class CustomAuthenticationException extends AuthenticationException {

    public CustomAuthenticationException(String msg) {
        super(msg);
    }

    public CustomAuthenticationException(String msg, Throwable cause) {
        super(msg, cause);
    }
}

• CustomAuthenticationException ক্লাসটি Spring Security এর AuthenticationException এক্সটেন্ড করে তৈরি করা হয়েছে, যাতে আপনি যে কোনো কাস্টম মেসেজ বা অন্যান্য তথ্য রাখতে পারেন।

ii. Authentication Failure Handler তৈরি করা

এখন, আমরা একটি AuthenticationFailureHandler তৈরি করব, যাতে Authentication ব্যর্থ হলে কাস্টম এক্সসেপশন পরিচালিত হয়।

import org.springframework.security.web.authentication.AuthenticationFailureHandler;
import org.springframework.security.core.AuthenticationException;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Component
public class CustomAuthenticationFailureHandler implements AuthenticationFailureHandler {

    @Override
    public void onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response,
                                        AuthenticationException exception) throws IOException {
        // কাস্টম মেসেজ বা লগিং করা যেতে পারে এখানে
        response.sendError(HttpServletResponse.SC_UNAUTHORIZED, "Authentication failed: " + exception.getMessage());
    }
}

• এখানে onAuthenticationFailure মেথডে Authentication ব্যর্থ হলে কাস্টম ত্রুটি বার্তা প্রদান করা হয়েছে। আপনি চাইলে আরও বিস্তারিত ত্রুটি বার্তা এবং লগিং যুক্ত করতে পারেন।

iii. Spring Security Configuration তে Custom Failure Handler যুক্ত করা

এখন, Spring Security কনফিগারেশন ফাইলে আমাদের এই কাস্টম Failure Handler যুক্ত করতে হবে।

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    private final CustomAuthenticationFailureHandler customAuthenticationFailureHandler;

    public SecurityConfig(CustomAuthenticationFailureHandler customAuthenticationFailureHandler) {
        this.customAuthenticationFailureHandler = customAuthenticationFailureHandler;
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/login", "/register").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login")
                .failureHandler(customAuthenticationFailureHandler)  // Custom Failure Handler
                .permitAll()
                .and()
            .logout()
                .permitAll();
    }
}

এখানে failureHandler(customAuthenticationFailureHandler) কল করে Spring Security কে জানানো হচ্ছে যে, যদি authentication ব্যর্থ হয়, তাহলে আমাদের কাস্টম failure handler কার্যকর হবে।

3. Custom Access Denied Handling

Spring Security তে যখন ব্যবহারকারী একটি সুরক্ষিত রিসোর্স অ্যাক্সেস করার চেষ্টা করে এবং সে অনুমোদিত না হয়, তখন AccessDeniedException ঘটে। আমরা কাস্টম AccessDeniedException হ্যান্ডলার ব্যবহার করে এই সমস্যাও সমাধান করতে পারি।

i. AccessDeniedHandler তৈরি করা

import org.springframework.security.web.access.AccessDeniedException;
import org.springframework.security.web.access.AccessDeniedHandler;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Component
public class CustomAccessDeniedHandler implements AccessDeniedHandler {

    @Override
    public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException {
        // কাস্টম এক্সেস ডিনাইড বার্তা
        response.sendError(HttpServletResponse.SC_FORBIDDEN, "Access Denied: " + accessDeniedException.getMessage());
    }
}

ii. Access Denied Handler Spring Security Configuration এ যুক্ত করা

এখন, SecurityConfig এ আমাদের CustomAccessDeniedHandler যুক্ত করতে হবে।

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    private final CustomAccessDeniedHandler customAccessDeniedHandler;

    public SecurityConfig(CustomAccessDeniedHandler customAccessDeniedHandler) {
        this.customAccessDeniedHandler = customAccessDeniedHandler;
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/admin/**").hasRole("ADMIN")  // Admin only endpoint
                .anyRequest().authenticated()
                .and()
            .exceptionHandling()
                .accessDeniedHandler(customAccessDeniedHandler)  // Custom Access Denied Handler
                .and()
            .formLogin()
                .permitAll()
                .and()
            .logout()
                .permitAll();
    }
}

এখানে accessDeniedHandler(customAccessDeniedHandler) ব্যবহার করে AccessDeniedException হলে আমাদের কাস্টম হ্যান্ডলার ব্যবহৃত হবে।

4. Global Exception Handling (Controller Level)

Spring MVC তে আপনি কাস্টম Exception Handler ব্যবহার করতে পারেন। যদি আপনি কিছু কাস্টম exception হ্যান্ডলিং করতে চান, তবে @ControllerAdvice ব্যবহার করতে পারেন।

import org.springframework.http.HttpStatus;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(CustomAuthenticationException.class)
    @ResponseStatus(HttpStatus.UNAUTHORIZED)
    public String handleCustomAuthenticationException(CustomAuthenticationException e, Model model) {
        model.addAttribute("error", e.getMessage());
        return "error";  // Return a custom error page
    }
}

এখানে @ExceptionHandler ব্যবহার করা হয়েছে কাস্টম exception হ্যান্ডল করার জন্য। এটি CustomAuthenticationException সনাক্ত করলে handleCustomAuthenticationException মেথডটি কল হবে এবং একটি কাস্টম error page রিটার্ন করবে।

5. Conclusion

Spring Security তে কাস্টম exception handling ব্যবহার করলে আপনি সিস্টেমের নিরাপত্তা এবং ব্যবহারকারীর অভিজ্ঞতাকে উন্নত করতে পারেন। আপনি AuthenticationException, AccessDeniedException এবং অন্যান্য exception গুলি কাস্টমাইজ করে ব্যবহারকারীদের আরও পরিষ্কার এবং কাস্টম ত্রুটি বার্তা প্রদান করতে পারেন। Spring Security তে এই কাস্টম হ্যান্ডলিং কনফিগারেশন খুব সহজেই করা যায় এবং এটি নিরাপত্তা এবং ব্যবহারের সুবিধা বাড়াতে সাহায্য করে।